@in-human-resources/backend-proto 0.1.4 → 0.1.5

package/api/v1/README.md

@@ -88,6 +88,13 @@ Manages candidate profiles and job applications:
 - Application readiness checks
 - Candidate onboarding flow
 
+### HiringService (`hiring.proto` + `pipeline.proto`)
+Jobs, applications, pipeline stages, and **M2.5 pipeline configuration**:
+- Job CRUD, publish/close, search; `CreateJob` / `UpdateJob` accept optional `pipeline_definition_id` (else company default or platform `standard_full`).
+- Apply, list applications, stage transitions, screening/interview/assessment/offer records, audit events.
+- **Pipeline settings (company):** `ListPlatformPipelineTemplates`, `ClonePipelineFromTemplate`, draft CRUD, `PublishPipelineDefinition`, `SetCompanyDefaultPipeline`, `SetJobPipelineDefinition`, `GetApplicationPipelineSnapshot`.
+- Messages live in `pipeline.proto` (`PipelineDefinition`, `PipelineBlock`, `PipelineSnapshot`, `ManualFieldSpec`). Regenerate clients with `make proto-gen`.
+
 ## Client Integration
 
 ### Mobile (Kotlin)

package/api/v1/hiring.proto

@@ -4,6 +4,8 @@ package api.v1;
 
 option go_package = "github.com/InHuman-Resources/Backend/Go/proto/gen/api/v1;apiv1";
 
+import "api/v1/pipeline.proto";
+
 // =============================================================================
 // api.v1 public contract — versioning and evolution (HiringService)
 // =============================================================================
@@ -74,6 +76,18 @@ service HiringService {
 
   // Audit/history timeline for one application (candidate or owning company).
   rpc ListApplicationEvents(ListApplicationEventsRequest) returns (ListApplicationEventsResponse);
+
+  // Pipeline configuration (M2.5)
+  rpc ListPlatformPipelineTemplates(ListPlatformPipelineTemplatesRequest) returns (ListPlatformPipelineTemplatesResponse);
+  rpc GetPipelineDefinition(GetPipelineDefinitionRequest) returns (PipelineDefinition);
+  rpc ListPipelineDefinitions(ListPipelineDefinitionsRequest) returns (ListPipelineDefinitionsResponse);
+  rpc CreatePipelineDefinition(CreatePipelineDefinitionRequest) returns (CreatePipelineDefinitionResponse);
+  rpc UpdatePipelineDefinition(UpdatePipelineDefinitionRequest) returns (PipelineDefinition);
+  rpc PublishPipelineDefinition(PublishPipelineDefinitionRequest) returns (PublishPipelineDefinitionResponse);
+  rpc ClonePipelineFromTemplate(ClonePipelineFromTemplateRequest) returns (ClonePipelineFromTemplateResponse);
+  rpc SetCompanyDefaultPipeline(SetCompanyDefaultPipelineRequest) returns (SetCompanyDefaultPipelineResponse);
+  rpc SetJobPipelineDefinition(SetJobPipelineDefinitionRequest) returns (Job);
+  rpc GetApplicationPipelineSnapshot(GetApplicationPipelineSnapshotRequest) returns (GetApplicationPipelineSnapshotResponse);
 }
 
 message PageRequest {
@@ -89,6 +103,7 @@ message CreateJobRequest {
   string title = 1;
   string description = 2;
   string public_slug = 3;
+  string pipeline_definition_id = 4;
 }
 
 message CreateJobResponse {
@@ -126,6 +141,7 @@ message Job {
   string team_metadata_json = 8;
   string created_at = 9;
   string updated_at = 10;
+  string pipeline_definition_id = 11;
 }
 
 message GetJobResponse {
@@ -139,6 +155,7 @@ message GetJobResponse {
   string team_metadata_json = 8;
   string created_at = 9;
   string updated_at = 10;
+  string pipeline_definition_id = 11;
 }
 
 message ListJobsRequest {
@@ -168,6 +185,7 @@ message UpdateJobRequest {
   string public_slug = 4;
   string requirements = 5;
   string team_metadata_json = 6;
+  string pipeline_definition_id = 7;
 }
 
 message UpdateJobResponse {
@@ -251,6 +269,7 @@ message RecordRecruiterDecisionRequest {
   string stage_context = 2;
   string outcome = 3;
   string reasoning = 4;
+  map<string, string> manual_inputs = 5;
 }
 
 message RecordRecruiterDecisionResponse {

package/api/v1/pipeline.proto

@@ -0,0 +1,156 @@
+syntax = "proto3";
+
+package api.v1;
+
+option go_package = "github.com/InHuman-Resources/Backend/Go/proto/gen/api/v1;apiv1";
+
+// Pipeline capability aligns with business hiring automation areas.
+enum PipelineCapability {
+  PIPELINE_CAPABILITY_UNSPECIFIED = 0;
+  PIPELINE_CAPABILITY_SCREENING = 1;
+  PIPELINE_CAPABILITY_RECRUITER_REVIEW = 2;
+  PIPELINE_CAPABILITY_ASSESSMENT = 3;
+  PIPELINE_CAPABILITY_INTERVIEW = 4;
+  PIPELINE_CAPABILITY_OFFER = 5;
+  PIPELINE_CAPABILITY_COMMUNICATION = 6;
+}
+
+enum PipelineStepType {
+  PIPELINE_STEP_TYPE_UNSPECIFIED = 0;
+  PIPELINE_STEP_TYPE_AUTOMATED = 1;
+  PIPELINE_STEP_TYPE_HUMAN_GATE = 2;
+  PIPELINE_STEP_TYPE_ASSESSMENT = 3;
+  PIPELINE_STEP_TYPE_INTERVIEW = 4;
+  PIPELINE_STEP_TYPE_OFFER = 5;
+}
+
+message BlockSLA {
+  int32 reminder_after_days = 1;
+  int32 escalate_after_days = 2;
+  int32 auto_reject_after_days = 3;
+}
+
+message ManualFieldSpec {
+  string id = 1;
+  string label = 2;
+  string type = 3;
+  bool required = 4;
+}
+
+message ManualFieldsConfig {
+  repeated ManualFieldSpec fields = 1;
+}
+
+message PipelineBlock {
+  string block_id = 1;
+  int32 sort_order = 2;
+  PipelineCapability capability = 3;
+  bool enabled = 4;
+  string display_name = 5;
+  string candidate_status_label = 6;
+  PipelineStepType step_type = 7;
+  BlockSLA sla = 8;
+  ManualFieldsConfig manual_fields = 9;
+  string config_json = 10;
+}
+
+message PipelineDefinition {
+  string definition_id = 1;
+  string company_id = 2;
+  string name = 3;
+  string description = 4;
+  string slug = 5;
+  int32 version = 6;
+  string status = 7;
+  bool is_platform = 8;
+  string source_template_id = 9;
+  int32 schema_version = 10;
+  repeated PipelineBlock blocks = 11;
+}
+
+message ExecutionStep {
+  string stage_id = 1;
+  PipelineStepType step_type = 2;
+  string block_id = 3;
+  PipelineCapability capability = 4;
+  BlockSLA sla = 5;
+  string config_json = 6;
+  string manual_fields_json = 7;
+}
+
+message PipelineSnapshot {
+  string definition_id = 1;
+  int32 definition_version = 2;
+  int32 schema_version = 3;
+  string definition_name = 4;
+  repeated ExecutionStep steps = 5;
+}
+
+message ListPlatformPipelineTemplatesRequest {}
+
+message ListPlatformPipelineTemplatesResponse {
+  repeated PipelineDefinition templates = 1;
+}
+
+message GetPipelineDefinitionRequest {
+  string definition_id = 1;
+}
+
+message ListPipelineDefinitionsRequest {}
+
+message ListPipelineDefinitionsResponse {
+  repeated PipelineDefinition definitions = 1;
+}
+
+message CreatePipelineDefinitionRequest {
+  string name = 1;
+  string description = 2;
+  repeated PipelineBlock blocks = 3;
+}
+
+message CreatePipelineDefinitionResponse {
+  string definition_id = 1;
+}
+
+message UpdatePipelineDefinitionRequest {
+  string definition_id = 1;
+  string name = 2;
+  string description = 3;
+  repeated PipelineBlock blocks = 4;
+}
+
+message PublishPipelineDefinitionRequest {
+  string definition_id = 1;
+}
+
+message PublishPipelineDefinitionResponse {
+  int32 version = 1;
+}
+
+message ClonePipelineFromTemplateRequest {
+  string template_id = 1;
+  string name = 2;
+}
+
+message ClonePipelineFromTemplateResponse {
+  string definition_id = 1;
+}
+
+message SetCompanyDefaultPipelineRequest {
+  string definition_id = 1;
+}
+
+message SetCompanyDefaultPipelineResponse {}
+
+message SetJobPipelineDefinitionRequest {
+  string job_id = 1;
+  string definition_id = 2;
+}
+
+message GetApplicationPipelineSnapshotRequest {
+  string application_id = 1;
+}
+
+message GetApplicationPipelineSnapshotResponse {
+  PipelineSnapshot snapshot = 1;
+}

package/gen/ts/workflow/v1/service_connect.ts

@@ -0,0 +1,87 @@
+// @generated by protoc-gen-connect-es v1.7.0 with parameter "target=ts,import_extension=none"
+// @generated from file workflow/v1/service.proto (package workflow.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+
+import { CancelWorkflowRequest, CancelWorkflowResponse, GetWorkflowStatusRequest, GetWorkflowStatusResponse, SignalAssessmentCompletedRequest, SignalAssessmentCompletedResponse, SignalInterviewBookedRequest, SignalInterviewBookedResponse, SignalOfferDecisionRequest, SignalOfferDecisionResponse, SignalRecruiterDecisionRequest, SignalRecruiterDecisionResponse, StartApplicationLifecycleRequest, StartApplicationLifecycleResponse } from "./service_pb";
+import { MethodKind } from "@bufbuild/protobuf";
+
+/**
+ * WorkflowService is private: API gateway and approved internal callers only.
+ * Drives Temporal application lifecycle; product clients use api.v1.HiringService.
+ *
+ * @generated from service workflow.v1.WorkflowService
+ */
+export const WorkflowService = {
+  typeName: "workflow.v1.WorkflowService",
+  methods: {
+    /**
+     * StartApplicationLifecycle starts (or idempotently re-attaches to) the root workflow for one application.
+     *
+     * @generated from rpc workflow.v1.WorkflowService.StartApplicationLifecycle
+     */
+    startApplicationLifecycle: {
+      name: "StartApplicationLifecycle",
+      I: StartApplicationLifecycleRequest,
+      O: StartApplicationLifecycleResponse,
+      kind: MethodKind.Unary,
+    },
+    /**
+     * @generated from rpc workflow.v1.WorkflowService.CancelWorkflow
+     */
+    cancelWorkflow: {
+      name: "CancelWorkflow",
+      I: CancelWorkflowRequest,
+      O: CancelWorkflowResponse,
+      kind: MethodKind.Unary,
+    },
+    /**
+     * Human / domain signals (Temporal signal names match RPC suffixes where applicable).
+     *
+     * @generated from rpc workflow.v1.WorkflowService.SignalRecruiterDecision
+     */
+    signalRecruiterDecision: {
+      name: "SignalRecruiterDecision",
+      I: SignalRecruiterDecisionRequest,
+      O: SignalRecruiterDecisionResponse,
+      kind: MethodKind.Unary,
+    },
+    /**
+     * @generated from rpc workflow.v1.WorkflowService.SignalAssessmentCompleted
+     */
+    signalAssessmentCompleted: {
+      name: "SignalAssessmentCompleted",
+      I: SignalAssessmentCompletedRequest,
+      O: SignalAssessmentCompletedResponse,
+      kind: MethodKind.Unary,
+    },
+    /**
+     * @generated from rpc workflow.v1.WorkflowService.SignalInterviewBooked
+     */
+    signalInterviewBooked: {
+      name: "SignalInterviewBooked",
+      I: SignalInterviewBookedRequest,
+      O: SignalInterviewBookedResponse,
+      kind: MethodKind.Unary,
+    },
+    /**
+     * @generated from rpc workflow.v1.WorkflowService.SignalOfferDecision
+     */
+    signalOfferDecision: {
+      name: "SignalOfferDecision",
+      I: SignalOfferDecisionRequest,
+      O: SignalOfferDecisionResponse,
+      kind: MethodKind.Unary,
+    },
+    /**
+     * @generated from rpc workflow.v1.WorkflowService.GetWorkflowStatus
+     */
+    getWorkflowStatus: {
+      name: "GetWorkflowStatus",
+      I: GetWorkflowStatusRequest,
+      O: GetWorkflowStatusResponse,
+      kind: MethodKind.Unary,
+    },
+  }
+} as const;
+

package/gen/ts/workflow/v1/service_pb.ts

@@ -0,0 +1,580 @@
+// @generated by protoc-gen-es v1.10.1 with parameter "target=ts,import_extension=none"
+// @generated from file workflow/v1/service.proto (package workflow.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+
+import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage } from "@bufbuild/protobuf";
+import { Message, proto3 } from "@bufbuild/protobuf";
+
+/**
+ * @generated from message workflow.v1.StartApplicationLifecycleRequest
+ */
+export class StartApplicationLifecycleRequest extends Message<StartApplicationLifecycleRequest> {
+  /**
+   * @generated from field: string application_id = 1;
+   */
+  applicationId = "";
+
+  /**
+   * @generated from field: string job_id = 2;
+   */
+  jobId = "";
+
+  /**
+   * @generated from field: string candidate_user_id = 3;
+   */
+  candidateUserId = "";
+
+  /**
+   * @generated from field: string company_id = 4;
+   */
+  companyId = "";
+
+  constructor(data?: PartialMessage<StartApplicationLifecycleRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.StartApplicationLifecycleRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "application_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "job_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "candidate_user_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "company_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): StartApplicationLifecycleRequest {
+    return new StartApplicationLifecycleRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): StartApplicationLifecycleRequest {
+    return new StartApplicationLifecycleRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): StartApplicationLifecycleRequest {
+    return new StartApplicationLifecycleRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: StartApplicationLifecycleRequest | PlainMessage<StartApplicationLifecycleRequest> | undefined, b: StartApplicationLifecycleRequest | PlainMessage<StartApplicationLifecycleRequest> | undefined): boolean {
+    return proto3.util.equals(StartApplicationLifecycleRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.StartApplicationLifecycleResponse
+ */
+export class StartApplicationLifecycleResponse extends Message<StartApplicationLifecycleResponse> {
+  /**
+   * @generated from field: string workflow_id = 1;
+   */
+  workflowId = "";
+
+  /**
+   * @generated from field: string run_id = 2;
+   */
+  runId = "";
+
+  constructor(data?: PartialMessage<StartApplicationLifecycleResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.StartApplicationLifecycleResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "workflow_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "run_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): StartApplicationLifecycleResponse {
+    return new StartApplicationLifecycleResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): StartApplicationLifecycleResponse {
+    return new StartApplicationLifecycleResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): StartApplicationLifecycleResponse {
+    return new StartApplicationLifecycleResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: StartApplicationLifecycleResponse | PlainMessage<StartApplicationLifecycleResponse> | undefined, b: StartApplicationLifecycleResponse | PlainMessage<StartApplicationLifecycleResponse> | undefined): boolean {
+    return proto3.util.equals(StartApplicationLifecycleResponse, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.CancelWorkflowRequest
+ */
+export class CancelWorkflowRequest extends Message<CancelWorkflowRequest> {
+  /**
+   * @generated from field: string application_id = 1;
+   */
+  applicationId = "";
+
+  constructor(data?: PartialMessage<CancelWorkflowRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.CancelWorkflowRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "application_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CancelWorkflowRequest {
+    return new CancelWorkflowRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CancelWorkflowRequest {
+    return new CancelWorkflowRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CancelWorkflowRequest {
+    return new CancelWorkflowRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: CancelWorkflowRequest | PlainMessage<CancelWorkflowRequest> | undefined, b: CancelWorkflowRequest | PlainMessage<CancelWorkflowRequest> | undefined): boolean {
+    return proto3.util.equals(CancelWorkflowRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.CancelWorkflowResponse
+ */
+export class CancelWorkflowResponse extends Message<CancelWorkflowResponse> {
+  constructor(data?: PartialMessage<CancelWorkflowResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.CancelWorkflowResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): CancelWorkflowResponse {
+    return new CancelWorkflowResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): CancelWorkflowResponse {
+    return new CancelWorkflowResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): CancelWorkflowResponse {
+    return new CancelWorkflowResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: CancelWorkflowResponse | PlainMessage<CancelWorkflowResponse> | undefined, b: CancelWorkflowResponse | PlainMessage<CancelWorkflowResponse> | undefined): boolean {
+    return proto3.util.equals(CancelWorkflowResponse, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalRecruiterDecisionRequest
+ */
+export class SignalRecruiterDecisionRequest extends Message<SignalRecruiterDecisionRequest> {
+  /**
+   * @generated from field: string application_id = 1;
+   */
+  applicationId = "";
+
+  /**
+   * approve advances pipeline; reject moves to rejected.
+   *
+   * @generated from field: bool approve = 2;
+   */
+  approve = false;
+
+  /**
+   * @generated from field: string reason = 3;
+   */
+  reason = "";
+
+  constructor(data?: PartialMessage<SignalRecruiterDecisionRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalRecruiterDecisionRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "application_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "approve", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 3, name: "reason", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalRecruiterDecisionRequest {
+    return new SignalRecruiterDecisionRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalRecruiterDecisionRequest {
+    return new SignalRecruiterDecisionRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalRecruiterDecisionRequest {
+    return new SignalRecruiterDecisionRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalRecruiterDecisionRequest | PlainMessage<SignalRecruiterDecisionRequest> | undefined, b: SignalRecruiterDecisionRequest | PlainMessage<SignalRecruiterDecisionRequest> | undefined): boolean {
+    return proto3.util.equals(SignalRecruiterDecisionRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalRecruiterDecisionResponse
+ */
+export class SignalRecruiterDecisionResponse extends Message<SignalRecruiterDecisionResponse> {
+  constructor(data?: PartialMessage<SignalRecruiterDecisionResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalRecruiterDecisionResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalRecruiterDecisionResponse {
+    return new SignalRecruiterDecisionResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalRecruiterDecisionResponse {
+    return new SignalRecruiterDecisionResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalRecruiterDecisionResponse {
+    return new SignalRecruiterDecisionResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalRecruiterDecisionResponse | PlainMessage<SignalRecruiterDecisionResponse> | undefined, b: SignalRecruiterDecisionResponse | PlainMessage<SignalRecruiterDecisionResponse> | undefined): boolean {
+    return proto3.util.equals(SignalRecruiterDecisionResponse, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalAssessmentCompletedRequest
+ */
+export class SignalAssessmentCompletedRequest extends Message<SignalAssessmentCompletedRequest> {
+  /**
+   * @generated from field: string application_id = 1;
+   */
+  applicationId = "";
+
+  /**
+   * @generated from field: string external_assessment_id = 2;
+   */
+  externalAssessmentId = "";
+
+  constructor(data?: PartialMessage<SignalAssessmentCompletedRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalAssessmentCompletedRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "application_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "external_assessment_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalAssessmentCompletedRequest {
+    return new SignalAssessmentCompletedRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalAssessmentCompletedRequest {
+    return new SignalAssessmentCompletedRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalAssessmentCompletedRequest {
+    return new SignalAssessmentCompletedRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalAssessmentCompletedRequest | PlainMessage<SignalAssessmentCompletedRequest> | undefined, b: SignalAssessmentCompletedRequest | PlainMessage<SignalAssessmentCompletedRequest> | undefined): boolean {
+    return proto3.util.equals(SignalAssessmentCompletedRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalAssessmentCompletedResponse
+ */
+export class SignalAssessmentCompletedResponse extends Message<SignalAssessmentCompletedResponse> {
+  constructor(data?: PartialMessage<SignalAssessmentCompletedResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalAssessmentCompletedResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalAssessmentCompletedResponse {
+    return new SignalAssessmentCompletedResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalAssessmentCompletedResponse {
+    return new SignalAssessmentCompletedResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalAssessmentCompletedResponse {
+    return new SignalAssessmentCompletedResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalAssessmentCompletedResponse | PlainMessage<SignalAssessmentCompletedResponse> | undefined, b: SignalAssessmentCompletedResponse | PlainMessage<SignalAssessmentCompletedResponse> | undefined): boolean {
+    return proto3.util.equals(SignalAssessmentCompletedResponse, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalInterviewBookedRequest
+ */
+export class SignalInterviewBookedRequest extends Message<SignalInterviewBookedRequest> {
+  /**
+   * @generated from field: string application_id = 1;
+   */
+  applicationId = "";
+
+  /**
+   * @generated from field: string scheduled_at_rfc3339 = 2;
+   */
+  scheduledAtRfc3339 = "";
+
+  constructor(data?: PartialMessage<SignalInterviewBookedRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalInterviewBookedRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "application_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "scheduled_at_rfc3339", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalInterviewBookedRequest {
+    return new SignalInterviewBookedRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalInterviewBookedRequest {
+    return new SignalInterviewBookedRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalInterviewBookedRequest {
+    return new SignalInterviewBookedRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalInterviewBookedRequest | PlainMessage<SignalInterviewBookedRequest> | undefined, b: SignalInterviewBookedRequest | PlainMessage<SignalInterviewBookedRequest> | undefined): boolean {
+    return proto3.util.equals(SignalInterviewBookedRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalInterviewBookedResponse
+ */
+export class SignalInterviewBookedResponse extends Message<SignalInterviewBookedResponse> {
+  constructor(data?: PartialMessage<SignalInterviewBookedResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalInterviewBookedResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalInterviewBookedResponse {
+    return new SignalInterviewBookedResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalInterviewBookedResponse {
+    return new SignalInterviewBookedResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalInterviewBookedResponse {
+    return new SignalInterviewBookedResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalInterviewBookedResponse | PlainMessage<SignalInterviewBookedResponse> | undefined, b: SignalInterviewBookedResponse | PlainMessage<SignalInterviewBookedResponse> | undefined): boolean {
+    return proto3.util.equals(SignalInterviewBookedResponse, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalOfferDecisionRequest
+ */
+export class SignalOfferDecisionRequest extends Message<SignalOfferDecisionRequest> {
+  /**
+   * @generated from field: string application_id = 1;
+   */
+  applicationId = "";
+
+  /**
+   * @generated from field: bool accepted = 2;
+   */
+  accepted = false;
+
+  /**
+   * @generated from field: string reason = 3;
+   */
+  reason = "";
+
+  constructor(data?: PartialMessage<SignalOfferDecisionRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalOfferDecisionRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "application_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "accepted", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 3, name: "reason", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalOfferDecisionRequest {
+    return new SignalOfferDecisionRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalOfferDecisionRequest {
+    return new SignalOfferDecisionRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalOfferDecisionRequest {
+    return new SignalOfferDecisionRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalOfferDecisionRequest | PlainMessage<SignalOfferDecisionRequest> | undefined, b: SignalOfferDecisionRequest | PlainMessage<SignalOfferDecisionRequest> | undefined): boolean {
+    return proto3.util.equals(SignalOfferDecisionRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.SignalOfferDecisionResponse
+ */
+export class SignalOfferDecisionResponse extends Message<SignalOfferDecisionResponse> {
+  constructor(data?: PartialMessage<SignalOfferDecisionResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.SignalOfferDecisionResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): SignalOfferDecisionResponse {
+    return new SignalOfferDecisionResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): SignalOfferDecisionResponse {
+    return new SignalOfferDecisionResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): SignalOfferDecisionResponse {
+    return new SignalOfferDecisionResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: SignalOfferDecisionResponse | PlainMessage<SignalOfferDecisionResponse> | undefined, b: SignalOfferDecisionResponse | PlainMessage<SignalOfferDecisionResponse> | undefined): boolean {
+    return proto3.util.equals(SignalOfferDecisionResponse, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.GetWorkflowStatusRequest
+ */
+export class GetWorkflowStatusRequest extends Message<GetWorkflowStatusRequest> {
+  /**
+   * @generated from field: string application_id = 1;
+   */
+  applicationId = "";
+
+  constructor(data?: PartialMessage<GetWorkflowStatusRequest>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.GetWorkflowStatusRequest";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "application_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetWorkflowStatusRequest {
+    return new GetWorkflowStatusRequest().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetWorkflowStatusRequest {
+    return new GetWorkflowStatusRequest().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetWorkflowStatusRequest {
+    return new GetWorkflowStatusRequest().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetWorkflowStatusRequest | PlainMessage<GetWorkflowStatusRequest> | undefined, b: GetWorkflowStatusRequest | PlainMessage<GetWorkflowStatusRequest> | undefined): boolean {
+    return proto3.util.equals(GetWorkflowStatusRequest, a, b);
+  }
+}
+
+/**
+ * @generated from message workflow.v1.GetWorkflowStatusResponse
+ */
+export class GetWorkflowStatusResponse extends Message<GetWorkflowStatusResponse> {
+  /**
+   * @generated from field: string workflow_id = 1;
+   */
+  workflowId = "";
+
+  /**
+   * @generated from field: string run_id = 2;
+   */
+  runId = "";
+
+  /**
+   * Temporal workflow status name, e.g. RUNNING, COMPLETED.
+   *
+   * @generated from field: string status = 3;
+   */
+  status = "";
+
+  /**
+   * Best-effort last known stage from workflow (may be empty if not yet started).
+   *
+   * @generated from field: string last_known_stage = 4;
+   */
+  lastKnownStage = "";
+
+  constructor(data?: PartialMessage<GetWorkflowStatusResponse>) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+
+  static readonly runtime: typeof proto3 = proto3;
+  static readonly typeName = "workflow.v1.GetWorkflowStatusResponse";
+  static readonly fields: FieldList = proto3.util.newFieldList(() => [
+    { no: 1, name: "workflow_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "run_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "status", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "last_known_stage", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ]);
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): GetWorkflowStatusResponse {
+    return new GetWorkflowStatusResponse().fromBinary(bytes, options);
+  }
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): GetWorkflowStatusResponse {
+    return new GetWorkflowStatusResponse().fromJson(jsonValue, options);
+  }
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): GetWorkflowStatusResponse {
+    return new GetWorkflowStatusResponse().fromJsonString(jsonString, options);
+  }
+
+  static equals(a: GetWorkflowStatusResponse | PlainMessage<GetWorkflowStatusResponse> | undefined, b: GetWorkflowStatusResponse | PlainMessage<GetWorkflowStatusResponse> | undefined): boolean {
+    return proto3.util.equals(GetWorkflowStatusResponse, a, b);
+  }
+}
+

package/hiring/v1/pipeline.proto

@@ -0,0 +1,156 @@
+syntax = "proto3";
+
+package hiring.v1;
+
+option go_package = "github.com/InHuman-Resources/Backend/Go/proto/gen/hiring/v1;hiringv1";
+
+// Pipeline capability aligns with business hiring automation areas.
+enum PipelineCapability {
+  PIPELINE_CAPABILITY_UNSPECIFIED = 0;
+  PIPELINE_CAPABILITY_SCREENING = 1;
+  PIPELINE_CAPABILITY_RECRUITER_REVIEW = 2;
+  PIPELINE_CAPABILITY_ASSESSMENT = 3;
+  PIPELINE_CAPABILITY_INTERVIEW = 4;
+  PIPELINE_CAPABILITY_OFFER = 5;
+  PIPELINE_CAPABILITY_COMMUNICATION = 6;
+}
+
+enum PipelineStepType {
+  PIPELINE_STEP_TYPE_UNSPECIFIED = 0;
+  PIPELINE_STEP_TYPE_AUTOMATED = 1;
+  PIPELINE_STEP_TYPE_HUMAN_GATE = 2;
+  PIPELINE_STEP_TYPE_ASSESSMENT = 3;
+  PIPELINE_STEP_TYPE_INTERVIEW = 4;
+  PIPELINE_STEP_TYPE_OFFER = 5;
+}
+
+message BlockSLA {
+  int32 reminder_after_days = 1;
+  int32 escalate_after_days = 2;
+  int32 auto_reject_after_days = 3;
+}
+
+message ManualFieldSpec {
+  string id = 1;
+  string label = 2;
+  string type = 3;
+  bool required = 4;
+}
+
+message ManualFieldsConfig {
+  repeated ManualFieldSpec fields = 1;
+}
+
+message PipelineBlock {
+  string block_id = 1;
+  int32 sort_order = 2;
+  PipelineCapability capability = 3;
+  bool enabled = 4;
+  string display_name = 5;
+  string candidate_status_label = 6;
+  PipelineStepType step_type = 7;
+  BlockSLA sla = 8;
+  ManualFieldsConfig manual_fields = 9;
+  string config_json = 10;
+}
+
+message PipelineDefinition {
+  string definition_id = 1;
+  string company_id = 2;
+  string name = 3;
+  string description = 4;
+  string slug = 5;
+  int32 version = 6;
+  string status = 7;
+  bool is_platform = 8;
+  string source_template_id = 9;
+  int32 schema_version = 10;
+  repeated PipelineBlock blocks = 11;
+}
+
+message ExecutionStep {
+  string stage_id = 1;
+  PipelineStepType step_type = 2;
+  string block_id = 3;
+  PipelineCapability capability = 4;
+  BlockSLA sla = 5;
+  string config_json = 6;
+  string manual_fields_json = 7;
+}
+
+message PipelineSnapshot {
+  string definition_id = 1;
+  int32 definition_version = 2;
+  int32 schema_version = 3;
+  string definition_name = 4;
+  repeated ExecutionStep steps = 5;
+}
+
+message ListPlatformPipelineTemplatesRequest {}
+
+message ListPlatformPipelineTemplatesResponse {
+  repeated PipelineDefinition templates = 1;
+}
+
+message GetPipelineDefinitionRequest {
+  string definition_id = 1;
+}
+
+message ListPipelineDefinitionsRequest {}
+
+message ListPipelineDefinitionsResponse {
+  repeated PipelineDefinition definitions = 1;
+}
+
+message CreatePipelineDefinitionRequest {
+  string name = 1;
+  string description = 2;
+  repeated PipelineBlock blocks = 3;
+}
+
+message CreatePipelineDefinitionResponse {
+  string definition_id = 1;
+}
+
+message UpdatePipelineDefinitionRequest {
+  string definition_id = 1;
+  string name = 2;
+  string description = 3;
+  repeated PipelineBlock blocks = 4;
+}
+
+message PublishPipelineDefinitionRequest {
+  string definition_id = 1;
+}
+
+message PublishPipelineDefinitionResponse {
+  int32 version = 1;
+}
+
+message ClonePipelineFromTemplateRequest {
+  string template_id = 1;
+  string name = 2;
+}
+
+message ClonePipelineFromTemplateResponse {
+  string definition_id = 1;
+}
+
+message SetCompanyDefaultPipelineRequest {
+  string definition_id = 1;
+}
+
+message SetCompanyDefaultPipelineResponse {}
+
+message SetJobPipelineDefinitionRequest {
+  string job_id = 1;
+  string definition_id = 2;
+}
+
+message GetApplicationPipelineSnapshotRequest {
+  string application_id = 1;
+}
+
+message GetApplicationPipelineSnapshotResponse {
+  PipelineSnapshot snapshot = 1;
+}

package/hiring/v1/service.proto

@@ -4,6 +4,8 @@ package hiring.v1;
 
 option go_package = "github.com/InHuman-Resources/Backend/Go/proto/gen/hiring/v1;hiringv1";
 
+import "hiring/v1/pipeline.proto";
+
 // HiringService is the private hiring API for the API gateway and approved internal callers
 // (e.g. workflow in M2). Product clients must use api.v1.HiringService on the gateway.
 service HiringService {
@@ -29,6 +31,18 @@ service HiringService {
   rpc LinkAssessment(LinkAssessmentRequest) returns (LinkAssessmentResponse);
   rpc RecordOffer(RecordOfferRequest) returns (RecordOfferResponse);
   rpc ListApplicationEvents(ListApplicationEventsRequest) returns (ListApplicationEventsResponse);
+
+  // Pipeline configuration (M2.5)
+  rpc ListPlatformPipelineTemplates(ListPlatformPipelineTemplatesRequest) returns (ListPlatformPipelineTemplatesResponse);
+  rpc GetPipelineDefinition(GetPipelineDefinitionRequest) returns (PipelineDefinition);
+  rpc ListPipelineDefinitions(ListPipelineDefinitionsRequest) returns (ListPipelineDefinitionsResponse);
+  rpc CreatePipelineDefinition(CreatePipelineDefinitionRequest) returns (CreatePipelineDefinitionResponse);
+  rpc UpdatePipelineDefinition(UpdatePipelineDefinitionRequest) returns (PipelineDefinition);
+  rpc PublishPipelineDefinition(PublishPipelineDefinitionRequest) returns (PublishPipelineDefinitionResponse);
+  rpc ClonePipelineFromTemplate(ClonePipelineFromTemplateRequest) returns (ClonePipelineFromTemplateResponse);
+  rpc SetCompanyDefaultPipeline(SetCompanyDefaultPipelineRequest) returns (SetCompanyDefaultPipelineResponse);
+  rpc SetJobPipelineDefinition(SetJobPipelineDefinitionRequest) returns (Job);
+  rpc GetApplicationPipelineSnapshot(GetApplicationPipelineSnapshotRequest) returns (GetApplicationPipelineSnapshotResponse);
 }
 
 // --- Pagination ---
@@ -48,6 +62,7 @@ message CreateJobRequest {
   string title = 1;
   string description = 2;
   string public_slug = 3;
+  string pipeline_definition_id = 4;
 }
 
 message CreateJobResponse {
@@ -77,6 +92,7 @@ message Job {
   string team_metadata_json = 8;
   string created_at = 9;
   string updated_at = 10;
+  string pipeline_definition_id = 11;
 }
 
 message GetJobResponse {
@@ -90,6 +106,7 @@ message GetJobResponse {
   string team_metadata_json = 8;
   string created_at = 9;
   string updated_at = 10;
+  string pipeline_definition_id = 11;
 }
 
 message ListJobsRequest {
@@ -119,6 +136,7 @@ message UpdateJobRequest {
   string public_slug = 4;
   string requirements = 5;
   string team_metadata_json = 6;
+  string pipeline_definition_id = 7;
 }
 
 message UpdateJobResponse {
@@ -216,6 +234,7 @@ message RecordRecruiterDecisionRequest {
   string stage_context = 2;
   string outcome = 3;
   string reasoning = 4;
+  map<string, string> manual_inputs = 5;
 }
 
 message RecordRecruiterDecisionResponse {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@in-human-resources/backend-proto",
-  "version": "0.1.4",
-  "description": "Protobuf-ES and Connect-ES generated clients for api.v1, auth.v1, hiring.v1, and common.v1",
+  "version": "0.1.5",
+  "description": "Protobuf-ES and Connect-ES generated clients for api.v1, auth.v1, hiring.v1, workflow.v1, and common.v1",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -10,6 +10,7 @@
     "api",
     "auth",
     "hiring",
+    "workflow",
     "common",
     "buf.yaml",
     "buf.gen.yaml"

package/workflow/v1/service.proto

@@ -0,0 +1,87 @@
+syntax = "proto3";
+
+package workflow.v1;
+
+option go_package = "github.com/InHuman-Resources/Backend/Go/proto/gen/workflow/v1;workflowv1";
+
+// WorkflowService is private: API gateway and approved internal callers only.
+// Drives Temporal application lifecycle; product clients use api.v1.HiringService.
+service WorkflowService {
+  // StartApplicationLifecycle starts (or idempotently re-attaches to) the root workflow for one application.
+  rpc StartApplicationLifecycle(StartApplicationLifecycleRequest) returns (StartApplicationLifecycleResponse);
+
+  rpc CancelWorkflow(CancelWorkflowRequest) returns (CancelWorkflowResponse);
+
+  // Human / domain signals (Temporal signal names match RPC suffixes where applicable).
+  rpc SignalRecruiterDecision(SignalRecruiterDecisionRequest) returns (SignalRecruiterDecisionResponse);
+  rpc SignalAssessmentCompleted(SignalAssessmentCompletedRequest) returns (SignalAssessmentCompletedResponse);
+  rpc SignalInterviewBooked(SignalInterviewBookedRequest) returns (SignalInterviewBookedResponse);
+  rpc SignalOfferDecision(SignalOfferDecisionRequest) returns (SignalOfferDecisionResponse);
+
+  rpc GetWorkflowStatus(GetWorkflowStatusRequest) returns (GetWorkflowStatusResponse);
+}
+
+message StartApplicationLifecycleRequest {
+  string application_id = 1;
+  string job_id = 2;
+  string candidate_user_id = 3;
+  string company_id = 4;
+  // JSON-encoded hiring PipelineSnapshot; when set, workflow interprets steps from snapshot.
+  string pipeline_snapshot_json = 5;
+}
+
+message StartApplicationLifecycleResponse {
+  string workflow_id = 1;
+  string run_id = 2;
+}
+
+message CancelWorkflowRequest {
+  string application_id = 1;
+}
+
+message CancelWorkflowResponse {}
+
+message SignalRecruiterDecisionRequest {
+  string application_id = 1;
+  // approve advances pipeline; reject moves to rejected.
+  bool approve = 2;
+  string reason = 3;
+  map<string, string> manual_inputs = 4;
+}
+
+message SignalRecruiterDecisionResponse {}
+
+message SignalAssessmentCompletedRequest {
+  string application_id = 1;
+  string external_assessment_id = 2;
+}
+
+message SignalAssessmentCompletedResponse {}
+
+message SignalInterviewBookedRequest {
+  string application_id = 1;
+  string scheduled_at_rfc3339 = 2;
+}
+
+message SignalInterviewBookedResponse {}
+
+message SignalOfferDecisionRequest {
+  string application_id = 1;
+  bool accepted = 2;
+  string reason = 3;
+}
+
+message SignalOfferDecisionResponse {}
+
+message GetWorkflowStatusRequest {
+  string application_id = 1;
+}
+
+message GetWorkflowStatusResponse {
+  string workflow_id = 1;
+  string run_id = 2;
+  // Temporal workflow status name, e.g. RUNNING, COMPLETED.
+  string status = 3;
+  // Best-effort last known stage from workflow (may be empty if not yet started).
+  string last_known_stage = 4;
+}