updateMetadata()

Update mutable SIGIL metadata fields for an agent.

Requires a SIGIL. See purchaseSigil().


const result = await agent.updateMetadata({
  substrate: 'frontier',
  substrate_provider: 'anthropic',
  substrate_model: 'claude-opus-4-6',
  capability: 'orchestrator',
  tools: ['web-search', 'code-execution'],
  modality_input: ['text', 'image'],
  modality_output: ['text'],
  protocol: 'http',
  compliance_regime: 'gdpr',
});
 
console.log(result.sigil);           // "myagent*acme*ind"
console.log(result.generation);      // 2
console.log(result.updated_fields);  // ["substrate", "substrate_provider", ...]

Parameters

fields: Partial<SigilMutableFields> - at least one field is required.

See PATCH /agent/metadata for the full field reference and allowed values.

Generation bump


await agent.updateMetadata({
  generation_trigger: 'retrained on v2 dataset',
  substrate_model: 'my-model-v2',
});
// agent.generation is now incremented

Return type


interface MetadataUpdateResult {
  ok: boolean;
  sigil?: string;
  generation?: number;
  updated_fields?: string[];
  error?: string;
}