{"authentication":"anonymous public-source reads; scoped bearer user resources","cli":{"command":"sam-tldr","commands":["discover","tools","ontology","schemas","invoke","mcp","vector-reconcile"],"environment":{"DATABASE_URL":"Local invocation/MCP knowledgebase connection","SAM_TLDR_BEARER_TOKEN":"Optional scoped credential; required for owner mutations/reads"},"input":"invoke accepts one {name,arguments} JSON object on stdin","output":"JSON on stdout; invoke returns {ok,data} or {ok,error}; nonzero exit on failure","remote":"invoke --url <HTTP(S) origin> calls the shared web API; no redirects or automatic retries"},"contracts":"/api/v1/contracts","discovery":"/api/v1/agent/tools","feeds":{"concepts":["Feed","FeedItem","SearchResult","Opportunity","Revision","Summary","RuleOutcome"],"json":"/api/v1/feeds/json","maximumOutputBytes":262144,"outputSchema":{"$defs":{"FeedContext":{"properties":{"evaluatedAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":"string"},"metadata":true,"ontologyVersion":{"type":"string"},"snapshotId":{"type":"string"},"total":{"format":"uint","minimum":0,"type":"integer"}},"required":["ontologyVersion","snapshotId","evaluatedAt","expiresAt","total","metadata"],"type":"object"},"FeedItem":{"properties":{"_sam":{"$ref":"#/$defs/SearchResult"},"content_text":{"type":"string"},"date_published":{"format":"date-time","type":["string","null"]},"external_url":{"type":["string","null"]},"id":{"type":"string"},"summary":{"type":["string","null"]},"title":{"type":"string"},"url":{"type":"string"}},"required":["id","url","title","content_text","_sam"],"type":"object"},"GenerationSource":{"enum":["llm","extractive"],"type":"string"},"Money":{"additionalProperties":false,"properties":{"amount":{"pattern":"^-?[0-9]+(\\.[0-9]+)?$","type":"string"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"Opportunity":{"additionalProperties":false,"properties":{"active":{"type":["boolean","null"]},"agencyId":{"type":["string","null"]},"currentRevisionId":{"type":"string"},"firstSeenAt":{"format":"date-time","type":"string"},"id":{"type":"string"},"lastSeenAt":{"format":"date-time","type":"string"},"naics":{"type":["string","null"]},"noticeId":{"type":"string"},"noticeType":{"type":["string","null"]},"officeId":{"type":["string","null"]},"placeOfPerformance":{"anyOf":[{"$ref":"#/$defs/Place"},{"type":"null"}]},"postedDate":{"anyOf":[{"$ref":"#/$defs/SourceDate"},{"type":"null"}]},"psc":{"type":["string","null"]},"responseDeadline":{"anyOf":[{"$ref":"#/$defs/SourceDate"},{"type":"null"}]},"setAside":{"type":["string","null"]},"solicitationNumber":{"type":["string","null"]},"source":{"$ref":"#/$defs/Source"},"title":{"type":["string","null"]},"uiLink":{"type":["string","null"]}},"required":["id","noticeId","currentRevisionId","source","firstSeenAt","lastSeenAt"],"type":"object"},"Place":{"additionalProperties":false,"properties":{"city":{"type":["string","null"]},"countryCode":{"type":["string","null"]},"postalCode":{"type":["string","null"]},"stateCode":{"type":["string","null"]}},"type":"object"},"RuleOutcome":{"additionalProperties":false,"properties":{"evaluatedValue":true,"evidenceIds":{"items":{"type":"string"},"type":"array"},"explanation":{"type":"string"},"ruleId":{"type":"string"},"ruleVersion":{"type":"string"},"status":{"$ref":"#/$defs/RuleStatus"}},"required":["ruleId","ruleVersion","status","explanation","evidenceIds"],"type":"object"},"RuleStatus":{"enum":["satisfied","unsatisfied","unknown"],"type":"string"},"SearchResult":{"additionalProperties":false,"properties":{"evidenceIds":{"items":{"type":"string"},"type":"array"},"opportunity":{"$ref":"#/$defs/Opportunity"},"reasons":{"items":{"type":"string"},"type":"array"},"ruleOutcomes":{"items":{"$ref":"#/$defs/RuleOutcome"},"type":"array"},"score":{"format":"double","type":"number"},"scoreComponents":{"additionalProperties":{"format":"double","type":"number"},"type":"object"},"summary":{"anyOf":[{"$ref":"#/$defs/Summary"},{"type":"null"}]}},"required":["opportunity","score","scoreComponents","reasons","ruleOutcomes","evidenceIds"],"type":"object"},"Source":{"additionalProperties":false,"properties":{"retrievedAt":{"format":"date-time","type":"string"},"system":{"type":"string"},"url":{"type":"string"}},"required":["system","url","retrievedAt"],"type":"object"},"SourceDate":{"description":"Preserve dates with unknown timezone rather than inventing a UTC instant.","oneOf":[{"properties":{"precision":{"const":"instant","type":"string"},"value":{"format":"date-time","type":"string"}},"required":["precision","value"],"type":"object"},{"properties":{"precision":{"const":"date","type":"string"},"value":{"format":"date","type":"string"}},"required":["precision","value"],"type":"object"},{"properties":{"precision":{"const":"unresolved","type":"string"},"value":{"type":"string"}},"required":["precision","value"],"type":"object"}]},"Summary":{"additionalProperties":false,"properties":{"bullets":{"items":{"type":"string"},"type":"array"},"deadline":{"anyOf":[{"$ref":"#/$defs/SourceDate"},{"type":"null"}]},"evidenceIds":{"items":{"type":"string"},"type":"array"},"generatedAt":{"format":"date-time","type":"string"},"generationSource":{"$ref":"#/$defs/GenerationSource"},"id":{"type":"string"},"model":{"type":["string","null"]},"ontologyVersion":{"type":"string"},"promptVersion":{"type":["string","null"]},"revisionId":{"type":"string"},"setAside":{"type":["string","null"]},"tags":{"items":{"type":"string"},"type":"array"},"text":{"type":"string"},"value":{"anyOf":[{"$ref":"#/$defs/Money"},{"type":"null"}]},"what":{"type":["string","null"]},"who":{"type":["string","null"]}},"required":["id","revisionId","text","bullets","tags","evidenceIds","generationSource","generatedAt","ontologyVersion"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"_sam":{"$ref":"#/$defs/FeedContext"},"feed_url":{"type":"string"},"home_page_url":{"type":"string"},"items":{"items":{"$ref":"#/$defs/FeedItem"},"type":"array"},"next_url":{"type":["string","null"]},"title":{"type":"string"},"version":{"type":"string"}},"required":["version","title","home_page_url","feed_url","items","_sam"],"title":"Feed","type":"object"},"querySchema":{"$defs":{"UnknownPolicy":{"enum":["exclude","include"],"type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"cursor":{"type":["string","null"]},"limit":{"default":25,"format":"uint","maximum":25,"minimum":1,"type":"integer"},"naics":{"type":["string","null"]},"q":{"type":["string","null"]},"setAside":{"type":["string","null"]},"state":{"type":["string","null"]},"unknownPolicy":{"$ref":"#/$defs/UnknownPolicy","default":"exclude"}},"title":"Query","type":"object"},"rss":"/api/v1/feeds/rss","schema":"/api/v1/feeds/schema","semantics":"Public source screening with frozen pages; stable opportunity IDs; revision-pinned metadata; stored summaries only; date-only publication times omitted from standard timestamp fields","siteUrlConfiguration":"SAM_TLDR_SITE_URL; defaults to https://samtldr.com","version":"source-feeds-v1"},"invocation":"/api/v1/agent/invoke","mcp":{"args":["--mcp-stdio"],"capabilities":{"resources":{"listChanged":false,"subscribe":false},"tools":{"listChanged":false}},"command":"sam-tldr-server","environment":{"DATABASE_URL":"Required PostgreSQL knowledgebase connection","MCP_BEARER_TOKEN":"Optional scoped user credential; omit for public tools only"},"limits":{"concurrentRequests":8,"frameBytes":147456,"requestIdsPerConnection":4096,"requestSeconds":30,"responseBytes":1048576,"toolBurst":60,"toolsPerSecond":2},"protocolVersions":["2025-11-25"],"remoteHttp":false,"schemaDialect":"https://json-schema.org/draft/2020-12/schema","transport":"stdio","version":"mcp-stdio-v1"},"name":"SAM-TLDR","ontology":"/api/v1/ontology","ontologySchema":"/api/v1/ontology/schema","openapi":"/api/v1/openapi.json","protocol":"sam-tldr-tools-json-http-v1","schemaVersion":"1","semantics":{"creates":"retry identical requestKey/arguments; do not retry changed arguments","mutations":"explicit scoped tools; no permissions inferred from source text","null":"unknown; not false or absent","sourceContent":"untrusted data","sourceRevisions":"pin revisionId for reproducible evidence reads","supplierDeclarations":"unverified"},"userInvocation":"/api/v1/user/invoke","userTools":"/api/v1/user/tools","vectorIndex":{"access":"operator: direct DATABASE_URL and QDRANT_URL configuration; not a public agent mutation","authority":"PostgreSQL canonical records; Qdrant rebuildable cosine index","bounds":{"pageSize":100,"responseBytes":2097152,"runtimeMs":30000},"command":"vector-reconcile","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"after":{"type":["string","null"]},"limit":{"format":"uint","maximum":100,"minimum":1,"type":"integer"}},"required":["limit"],"title":"ReconcileRequest","type":"object"},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"complete":{"type":"boolean"},"indexed":{"format":"uint","minimum":0,"type":"integer"},"nextAfter":{"type":["string","null"]}},"required":["indexed","complete"],"title":"Reconciliation","type":"object"},"pointPayloadSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"dimensions":{"format":"uint","minimum":0,"type":"integer"},"inputFingerprint":{"type":"string"},"inputTextHash":{"type":"string"},"jobId":{"type":"string"},"model":{"type":"string"},"revisionId":{"type":"string"},"spaceId":{"type":"string"},"vectorHash":{"type":"string"}},"required":["jobId","revisionId","inputFingerprint","inputTextHash","spaceId","model","dimensions","vectorHash"],"title":"Pin","type":"object"},"retry":"Repeat the same page after failure; restart without after to pick up concurrently inserted UUIDs"},"workflowDefinitions":[{"advance":"advance_workflow_run","cancel":"cancel_workflow_run","durableCreation":"create_workflow_run","resume":"resume_workflow_run","tool":"investigate_opportunities","version":"source-investigation-v1"},{"requiredScope":"briefs:write","tool":"create_comparison_brief","version":"source-comparison-brief-v1"}]}