Release v1.1.2

[roeai-release-bot]

This PR updates the Python SDK for release 1.1.2.

Generated from:

• roe-main release branch 1-0-85
• roe-main commit febae71dfde8bf0af6928e938ffd95bd506687be

[greptile-apps]

Greptile Summary

This release (v1.1.2) adds a new KnowledgeBaseAPI with 13 operations for managing knowledge base lenses and drafts, introduces a retrieve_artifact method on AgentJobsAPI, and updates cancel_all to return a structured AgentJobCancelAllResponse body (previously None/204). The previously flagged download_reference bug — where organization_id was passed as a stale kwarg to the updated generated function — is correctly resolved.

• KnowledgeBaseAPI (src/roe/api/knowledge_base.py): new hand-maintained wrapper covering list, create, retrieve, delete, poll_draft, patch_selection, regenerate, resolve, finalize, sync, catalog, lens_by_atlas_id, and import_lens, following the same request_raw + translate_response pattern as other wrapper APIs.
• Agent jobs updates: retrieve_artifact fetches a stripped artifact result by key; cancel_all now parses and returns a structured JSON body with task_id, targeted_count, and note.
• Test coverage: transport-layer tests added for all three new agent job methods and four representative knowledge-base operations.

Confidence Score: 5/5

Safe to merge; the new KnowledgeBaseAPI and agent job additions follow established patterns and the previously broken download_reference call is corrected.

All changed paths follow the existing request_raw / translate_response / from_dict contract. The cancel_all return-type change is matched in the generated module, the wrapper, and the tests. The only inconsistency found is a cosmetic coercion style nit on retrieve_artifact that does not affect correctness for valid UUID inputs.

src/roe/api/agents.py — the retrieve_artifact method omits the UUID(str(...)) coercion used by all other job-ID calls; not a blocker but worth aligning.

Important Files Changed

Filename	Overview
src/roe/api/agents.py	Adds retrieve_artifact (new) and updates cancel_all to return a structured body; download_reference bug (extra organization_id kwarg) is correctly removed. Minor: retrieve_artifact omits the UUID(str(...)) coercion used by all other job-ID methods.
src/roe/api/knowledge_base.py	New hand-maintained wrapper for 13 knowledge-base operations; follows the same request_raw + translate_response pattern as agents/policies. Body construction, UUID coercion, and UNSET fall-backs all look correct.
src/roe/client.py	Wires KnowledgeBaseAPI into RoeClient following the same pattern as AgentsAPI, PoliciesAPI, and UsersAPI.
src/roe/_generated/api/agents/agents_jobs_artifacts_result_retrieve.py	New generated endpoint for GET /v1/agents/jobs/{agent_job_id}/artifacts/result/; agent_job_id typed as str (not UUID) and URL-encoded correctly via quote(str(...), safe="").
src/roe/_generated/api/agents/agents_jobs_cancel_all_create.py	Updated from 204 (no-content) to 200 with AgentJobCancelAllResponse JSON body; return-type annotations updated consistently across all four function variants.
src/roe/_generated/api/agents/agents_jobs_references_retrieve.py	Removes organization_id query param from _get_kwargs and all four function signatures; fixes the previously reported TypeError in download_reference.
tests/unit/test_agents_wrapper_transport.py	Adds three new tests: download_reference omits organization_id, retrieve_artifact sends artifact_key and org query, and cancel_all returns a structured response body.
tests/unit/test_knowledge_base_wrapper_transport.py	New transport-layer tests covering create, list, patch_selection, and delete; tests verify HTTP method, query params, and request body round-trips.

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
    participant Caller
    participant RoeClient
    participant KnowledgeBaseAPI
    participant AgentJobsAPI
    participant request_raw
    participant GeneratedEndpoint
    participant Server

    Note over Caller,Server: Knowledge Base flow
    Caller->>RoeClient: client.knowledge_base.create(company, brief)
    RoeClient->>KnowledgeBaseAPI: create(company, brief)
    KnowledgeBaseAPI->>request_raw: "knowledge_base_create, body=CreateKnowledgeBaseRequest"
    request_raw->>GeneratedEndpoint: _get_kwargs(body, organization_id)
    request_raw->>Server: POST /v1/knowledge-base/
    Server-->>request_raw: "201 {id, status, ...}"
    request_raw->>KnowledgeBaseAPI: response
    KnowledgeBaseAPI-->>Caller: CreateKnowledgeBase

    Note over Caller,Server: Artifact retrieval flow
    Caller->>AgentJobsAPI: jobs.retrieve_artifact(job_id, artifact_key)
    AgentJobsAPI->>request_raw: agents_jobs_artifacts_result_retrieve, str(job_id), artifact_key
    request_raw->>GeneratedEndpoint: _get_kwargs(agent_job_id, artifact_key, organization_id)
    request_raw->>Server: "GET /v1/agents/jobs/{id}/artifacts/result/?artifact_key=..."
    Server-->>request_raw: "200 {result: {...}}"
    request_raw->>AgentJobsAPI: response
    AgentJobsAPI-->>Caller: AgentJobArtifactResult

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
    participant Caller
    participant RoeClient
    participant KnowledgeBaseAPI
    participant AgentJobsAPI
    participant request_raw
    participant GeneratedEndpoint
    participant Server

    Note over Caller,Server: Knowledge Base flow
    Caller->>RoeClient: client.knowledge_base.create(company, brief)
    RoeClient->>KnowledgeBaseAPI: create(company, brief)
    KnowledgeBaseAPI->>request_raw: "knowledge_base_create, body=CreateKnowledgeBaseRequest"
    request_raw->>GeneratedEndpoint: _get_kwargs(body, organization_id)
    request_raw->>Server: POST /v1/knowledge-base/
    Server-->>request_raw: "201 {id, status, ...}"
    request_raw->>KnowledgeBaseAPI: response
    KnowledgeBaseAPI-->>Caller: CreateKnowledgeBase

    Note over Caller,Server: Artifact retrieval flow
    Caller->>AgentJobsAPI: jobs.retrieve_artifact(job_id, artifact_key)
    AgentJobsAPI->>request_raw: agents_jobs_artifacts_result_retrieve, str(job_id), artifact_key
    request_raw->>GeneratedEndpoint: _get_kwargs(agent_job_id, artifact_key, organization_id)
    request_raw->>Server: "GET /v1/agents/jobs/{id}/artifacts/result/?artifact_key=..."
    Server-->>request_raw: "200 {result: {...}}"
    request_raw->>AgentJobsAPI: response
    AgentJobsAPI-->>Caller: AgentJobArtifactResult

Loading

_{Reviews (4): Last reviewed commit: "fix(agents): update jobs wrapper for 1-0..." | Re-trigger Greptile}

[Chen-ROE]

@greptile

[Chen-ROE]

@greptile

[Chen-ROE]

@greptile